Skip to main content
POST
/
receive
/
metrics
/
jobs
/
{jobId}
Upload a file and (optionally) execute or schedule
curl --request POST \
  --url https://{host}/receive/metrics/jobs/{jobId} \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "jobId": "<string>",
  "name": "<string>",
  "job_status": {
    "code": 123,
    "message": "<string>",
    "files": [
      {
        "name": "<string>",
        "size": 123
      }
    ]
  }
}

Path Parameters

​
jobId
string
required

Job GUID.

Query Parameters

​
execute
enum<string>

Execute now or at time (true) or just upload (false; default).

Available options:
true,
false
​
time
string

HH:mm (24-hour) time used with execute=true.

Body

multipart/form-data
​
file
file
required

Response

Upload accepted; execution may be scheduled or performed

​
jobId
string
required
​
name
string
required
​
job_status
object

Status of the last/active job operation:

  • code: 0 success; -1 error (or last audit load code if no statuscode.txt)
  • message: from statusmessage.txt (or last audit load status)
  • files: non-status files in the job status folder.